[ <<>> ] Succubus Heart [ <<>> ]
[<>] The Succubus Gameplay Mod [<>]

created by : Michael Stanich aka Spirit Shard
Site - michaelpstanich.com

[ <<>> ] Latest News [ <<>> ]
1) Succubus Heart 3.43 is released! Introduced a new way to level and obtain passives which should help with the requirement-creep of XP, note that because of this I've decided to reset all passives to zero and provide some XP back. Patch-notes for more.

Also, next point-O patch I'm going to be adding in the rest of the pets planned for Soul Pets 1.0, if you have creatures/humanoids you'd like to see included please let me know! (Currently Planned to integrate which are not in already [Familiar, Death Hound, Bear, Skeever, Chaurus, Falmer, Sabre Cat, Horker, Troll, Draugr, Spriggan, Flame Atronach, and some variants (Such as a second, more leveled horse)] DLC pets will be added in a later patch.)

2) So.. I broke my other mod Soul Pets like, massively... So I've decided to just work on the integrated version first now that I (somewhat) know what I'm doing then I'll create the standalone version later. This means Soul Pets is now integrating into Succubus Heart! (NOTE : Soul Pets standalone was broken do to my learning steps, reverted a lot of things while trying different methods so it needs to be re-written. Thought this was a better move so that I at least have the framework here.)

3) I'm officially cutting 'Succubus Spell' development outside of a few exceptions (I'm refering to combat/support oriented spells, not Seduction and sex spells). I don't think they were ever really popular and as people have mentioned there are loads of spells already made for Skyrim so developing new/interesting spells can be quite time consuming (and has proven to be less fun for me...). On-top of that I want to focus Succubus Heart more on it's strong points at the moment, which is progression and some interesting mechanics which I can hopefully polish up as much as possible. If anyone has some interesting ideas and wants to make some spells for Succubus Heart let me know and I'll help the best I can though!

_____

[ <<>> ] What is Succubus Heart? [ <<>> ]
Succubus Heart is an adult gameplay mod focused on creating new ways to approach playing Skyrim with both new progression and new game mechanics. These mechanics give the player the power of a succubus enabling the use of life-drain and great sacrificial powers. Succubus Heart is built around the idea of being a complimentary mod and should be compatible with nearly every mod out there!

[ <<>> ] What's So Unique? [ <<>> ]
Succubus Heart isn't a transformation mod, or a power fantasy mod, instead mechanics are focused on making gameplay more interesting and offering the player new ways to approach situations. Succubus Heart can also be used on male characters, turning them into a soul sucking Incubus! While most succubus mods focus on the demon-archtype Succubus Heart's approach is based on a fantasy race of life-weavers giving a more human-but-powerful vibe. However if you want some succubus transformations or want to use Succubus Heart alongside other succubus mods nothing is stopping you!

[ <<>> ] Mechanics [ <<>> ]
Heart System : Your succubus will earn XP through sexual acts and certain items which can be spent to learn new and improve their existing abilities! You'll also absorb life force from your partners, permanently decreasing their status while improving your own!

Skill Leveling : Take your overflowing life force and level Skyrim's usual Skills using SP earned. You can also convert any unwanted XP into SP if so desired.

Sex Drops : Orgasms will give partners their special juices (Sperm and Milk) which can be consumed or used in alchemy! There's also a chance at getting rare drops which have special effects when consumed (or you can be boring and use them in alchemy...).

Death Drops : After death characters will keep a small soul item which can then be taken and used by the player for various bonuses.

Succubus Passives : Unlock and rank up a variety of Succubus Passives which give advantages in combat, make progression run more smoothly, or just makes things a bit more... appealing.

Soul Pets : Another mod fully integrated into Succubus Heart with unique features! Soul Pets are summonable followers (both creature and human) which level through acts. As levels increase not only do pets become more powerful but the summoner's abilities improve adding new bonuses and unlocking more summons!

Combat Seduction : A simple combat submit mod, built right in! Initially built for testing, the feature can be handy if you're looking for a light-weight alternative to other submit mods. However I recommend disabling this feature if you have other submit mods running to avoid issues.

Death Override Mode : (Currently in early development phases and may be error prone) A simple Death Alternative which respawns the player when health hits 0 instead of just promting a reload. You can even turn Skyrim into a 'rogue-lite' by enabling item loss on death, introducing new gameplay approaches! I recommend leaving this disabled if you use any other Death Alternative type mod.

[ <<>> ] WARNING : Script Mod [ <<>> ]
While Succubus Heart is fairly light weight in the majority of cases it is a heavily script based mod. If your game is already having issues with script latency and overload I recommend backing up your saves before trying out Succubus Heart (and/or possibly decreasing your script load). I've done what I can to ensure Succubus Heart is as bug/error free as possible however under script lag any mod can begin throwing up errors and I can't guarantee Succubus Heart's performance.

[ <<>> ] What's Included [ <<>> ]
- Docs (Read Me - ChangeLog - Source Notes)
- Data (Everything for the core mod)
- Optional Uncapper Settings (Customized Skyrim Com. Unc. Settings)

[ <<>> ] Requirements [ <<>> ]
- SKSE 1.07.03 or newer [ http://skse.silverlock.org/ ]
- SexLab v1.62 or newer
- Sky UI 5.1 or newer [ http://www.nexusmods.com/skyrim/mods/3863/? ]

[ <<>> ] Recommended Mods [ <<>> ]
- Skyrim Community Uncapper [ http://www.nexusmods.com/skyrim/mods/1175/? ]

[ <<>> ] Installing / Updating [ <<>> ]
Installing : Simply copy Succubus Heart's "Data" folder to your Skyrim install, merging with that "Data" folder, then install any optional content you wish to use.

Updating : If you're using version 2.73x or before you'll need to do a 'clean' save before moving to 3.0. If updating above 3.4 It is recommend to reset the Succubus Realm Cell.

[ <<>> ] Uninstalling / Removal [ <<>> ]
Disable the mod then perform a clean save. After the clean save delete the "Succubus Heart.esp" and all files pre-fixed with "SuH_" and other files from the Succubus Heart mod from your Skyrim's "Data" folder. It is recommended to either load a game from before you had Succubus Heart installed or start a new game after uninstalling.

[ <<>> ] External Mod Support [ <<>> ]
Succubus Heart features are easy to access and modify, if anyone wants to create add-ons and additional mods feel free! If you have questions or any issues feel free to message me.

[ <<>> ] Known Issues [ <<>> ]
- Combat Seduction will sometimes trigger 'overlapping' animations under heavy script lag
- Using Soul Pets with other Animal Follower mods may cause strange behavior on both mods. (I recommend not summoning a Soul Pet while the other Animal Follower is following you)
- Soul Pets will sometimes and sometimes not teleport to the player when they should or shouldn't (example : When entering whiterun from the front gate they won't follow) If your pet is missing just re-summon them in the MCM.
- Death Override Mode can cause major issues with certain quests if you die and move outside of the quest's dedicated area. (When in this situation either move the spawn point with debug options or disable for the quest)
- General script latency problems do to the nature of script modding (Heavy script lag may cause issues with Succubus Heart)

[ <<>> ] FAQ [ <<>> ]
Q: I thought Soul Pets was going to be a completely separate mod, why is it now integrated?
A: In honesty I completely screwed up the stand-alone's code so instead of re-writing from scratch (again) I just moved onto making an integrated version first, When Succubus Heart reaches 4.0 (which includes the planned Soul Pets 1.0) I'll work on the standalone.

Q: But I didn't want Soul Pets, can it be removed?
A: No, however I've built it in such a way that it doesn't do anything if you don't use it so just ignore the Soul Pets MCM if you don't want to use it. Sorry!

Q: You're not making anymore Succubus Spells? What is "Legacy"?
A: Legacy refers to features that are in the mod but no longer supported, I didn't really feel like 'removing' more content in-case people wanted to still use it. As for spells I'm still working on Seduction (sex) spells but combat and support spells were impossible to balance and didn't really add to the mod in any interesting ways, so I'm spending that development time elsewhere.

Q: Why did you re-write the mod and end up removing features?
A: Removing features was never part of the plan but rather just a side effect. The original write was based on a flawed framework and the entire mod had become a grouping of work-around, causing bugs which I couldn't fix. The re-write allowed me to rebuild the foundation and build a more cohesive mod with better mechanics and synergy.

Q: Can I still level like in vanilla?
A: Of course! Succubus Heart doesn't alter any external scripts so other leveling methods should work as they always have.

Q: Can I use this mod as a male character?
A: Yep! Succubus Heart supports both genders.

Q: The MCM isn't showing and nothing seems to work!
A: Sounds like something installed incorrectly, try a clean install of the mod and make sure your files downloaded/extracted properly.

Q: _____ feels overpowered / underpowered, can you balance it?
A: I can try! If you have balance concerns make sure to send them my way and I'll work my best to work on it.

Changelog (Only contains the re-write notes)
[Spoiler]
Succubus Heart 3.43
- Removed extra unused script in release package (SuH_comES_soulofmagicka)
- Removed Charge sound on Focus Shot (Will hopefully fix a report of 'stuck' sounds)
- Changed "Spells / Passives" menu to just "Passives" (Spells are now Legacy, any new spells will be considered a passive with the ranking mechanic)
- Changed Succubus Realm's Nav-Mesh (Made a new one and deleted an extra one I didn't see before, should fix more cases of NPCs disappearing and help their combat)
- Changed Spirit's items and combat AI (Also removed her 'extra' shield)
- Changed using souls (and other future items/bonuses) will no longer increase XP costs
- Changed the way Passives are learned (Read BDSM addition below)
- Added a 'Tracking' system (Use the MCM's "Set to Default" key and it will leave a notification when you have enough XP to level it. Only works on items that require XP to level)
- Added stuffs to the "Help" MCM (Tracking, connect/disconnect spells, BDSM Rating, Updated some others)
- Added BDSM rating system (Improving Heart Levels gives BDSM rating while learning passives will decrease it. Passives no-longer take XP but instead require BDSM Rating)
- Added Stamina Effect Path to Masochist (Lose health but recover stamina)
- Added Second path to Luscious Liquids (Split it up to be Heal Health and Recover Magicka/Stamina)
- Added Death Drops path to Perfect Orgasm (Lose status but gain a chance at death drops)
- Added a "Reset" option for Passives (This will also re-calculate the BDSM Rating)
- Added "Script Skip" system to some heavier script (This will skip large processes when script is lagging, such as Combat Seduction. Should help prevent weird value changes and overlapping calculations but will make some mechanics feel less 'responsive' when script lag is too high.)
- Fixed Spirit's items for sell not resetting
- Fixed "Vitality Stone" resetting Status Caps
- Fixed Soul Drops dropping on characters that 'live' twice (such as revived characters, fix doesn't work if the game is 're-loaded' after a character dies and then revived after the load)
- Fixed Pet Desire generating weird and exponentially (Because the script is on delay and I switched to 'per-second' increments desire can still go above cap, but not much)
- Fixed Typos / Errors (I'm just going to have this on every patch from now on, let's see if anyone even notices the fixes)
_____
Succubus Heart 3.42 (NOTE: In-game it reads as 3.411)
- Changed Succubus Realm's Lighting to make it feel 'colder'
- Added Location data to Succubus Realm (SR) (Should help fix teleporting)
- Added Succubus Realm -Disconnect- Spell (Will return the player to where they were when connecting to the Succubus Realm. You'll have to use Connect outside of SR after update first for this to work.)
- Added Soul Pet Desire system (Desire generates when not summoned by 1+level per second, it decays when summoned or in acts and will return to the SR when desire reaches 0 or below. Caps at 100+100*level)
- Fixed SR Connect can no longer be used while in SR
- Fixed NPC AI Packages causing Spirit/Tali randomly leaving the Succubus Realm (Pets still disappear, no idea why)
- Fixed Consent Drain not working (no idea when it originally broke)
- Fixed a few papyrus error reports (no gameplay effect)
- Fixed? combat Seduction causing creatures to act on one-another (technically a SexLab issue, I just disabled creatures triggering each-other, will revert if/when SexLab fixes it.)
_____
Succubus Heart 3.41
- Changed Soul Pet AI Package List
- Changed Death Override Mode to spawn the player in the Succubus Realm (Use fast-travel to leave)
- Changed Succubus Realm Layout / Dimensions (Updates on next visit)
- Added actual content to the Succubus Realm (SR) (Detailed Below)
- Added special spawn location in the SR
- Added 'recovery' merchant to SR named Tali (She sells you back stuff you lost from death override mode)
- Added Succubus Merchant to SR named Spirit (She sells a set number of SuH items and a few extras)
- Added Crafting Objects to SR
- Added/Enabled Teleport spell to SR (Succubus Realm -Connect-)
- Fixed Lose Items Option for Death Override Mode not disabling
- Fixed all pet's AI and Tags (The wolf is no longer a 'bandit dog' and the horse should now be ride-able in 'both' ways... They still don't wonder on their own, working on that one.)
- (3.4) Fixed MCM not updating pages properly
- Fixed Typos in the MCM (I'll get them all eventually...)
_____
Succubus Heart 3.4
- Integration of Soul Pets into Succubus Heart has begun
- - - Soul Pets will still have a standalone version for non-SuH users in the future
- Changed primary update rate to 1 second (from 5)
- - - This is less error prone but higher in script weight, no direct gameplay effect
- Changed MCM structure in most menus to be easier to navigate / search
- Changed Soul of Life/Magic/Power cap increase to 2 (was 1)
- Changed Vitality Stone cap increase to 5 (was 2)
- Changed minimum status to 10 (was 1)
- Changed Spells / Passives menu to have spells as "Legacy" (Menu will be "Passives" in the future)
- Added a Death Override Mode which respawns the player instead of dieing (WARNING : Currently in a very basic state and could cause issues, leave disabled if you use other death alternative mods)
- - - Currently the "DEBUG" option in the MCM must be used to make a spawn point otherwise you'll appear in the incomplete 'Succubus Realm' (use any fast-travel command to leave)
- Added a 'Succubus Realm' (Currently incomplete)
- Added "Restrict Act" setting (limits SuH tiggered animation tags)
- Added Soul Pets Mechanics! (Fully integrated my other mod into SuH)
- Added Dog Pet for summoning
- Added Wolf Pet for summoning
- Added Horse Pet for Summoning
- Added Train Pet spell (Starts act with currently summoned pet)
- Added automatic pet recovery system (moves pet to player when changing locations.. most of the time)
- Fixed Always Drain Kill option not enabling
- Fixed Skill Level calculating buffs into SP cost
- Fixed a few Typos (there's still more tho...)
_____
Succubus Heart 3.2
- Changed XP Gain now earns 2% upon leveling in Heart Levels
- Changed XP cost to be halved (refer change above)
- Changed Force Mastery to decrease by 2% per level (Was 1%)
- Added Force required for SP now decreases with player level
- Added notification when Desire Drain begins draining status
- Fixed several spells learning without XP actually being consumed
- Fixed Status Overrides not working/displaying properly
- Fixed Cursed Blood [Hate] not working in all cases
- (3.21) Fixed incorrect values triggering when player was victim
- (3.22) Added method for pets from my "Soul Pets" mod to ignore absorption
- (3.23) Uh.. I messed up 3.22 by implementing the reverse effect... fixed now!
_____
Succubus Heart 3.1
- Changed the MCM menu name to "_Succubus Heart" so it appears at the top
- - - (MUST USE "setstage SKI_ConfigManagerInstance 1" in console to reset MCM names/registers)
- Changed XP level scaling on all default drain and consumption effects to 5 (was 2 and 1)
- Changed default Desire Generation to 1 per second (was 0.4 per second)
- Changed Desire Drain limit to 1200 (drain begins at and above 1200)
- Changed Sexual Entice Desire requirement to 300
- Changed Sexual Enrage Desire requirement to 120
- Added Desire Generation setting (changes Desire gained for every second, can be 0)
- Added Drain Always Kills option (ignores health and tries to drain kill every act with drain)
- Added level scaling to status caps (Adds 2 status per level)
- Added another overlap check to combat seduction (Player should not overlap in any scenario)
- Fixed/Changed some MCM typos and Help entry wording
_____
Succubus Heart 3.0
- Changed - Optional - Uncapper no longer gives status on level-up
- Changed Seduction Spell visual effects
- Changed Seduction Spell cast time to be lower (0.5 -> 0.2sec)
- Changed Death Drops to always give a drop when enabled
- Changed Status Cap Level costs to scale linearly (instead of exponentially)
- Changed Base XP earn value (20->25)
- Added overlap check to combat seduction to help prevent overlapping animations
- Added Death Drops option [Enables/Disables Death Drops Mechanic]
- Added level scaling to Soul of Experience [Gives 2 bonus XP per-level]
- Fixed Seduction Spells having Hit Events (would trigger Submit Mods)
- Fixed some missing references
_____
Succubus Heart BETA 3.x (0.7)
- Changed XP values for Heart Levels (For more senseable scaling)
- Changed Level Scaled XP (More XP for Higher Levels)
- Changed Drop Rates so rares/uncommons appear more often
- Changed/Added visual effects for all spells
- Added 'Blank Page' cover image to the MCM
- Added Desire Drain option (Enables/Disables Desire Drain Mechanic)
- Added cast time and skill leveling to all spells
- Added Status Cap and Absorption Override options
- Added Hover/Display text to Help's Reference Category
- Fixed incorrect MCM sorting
- Fixed empty MCM entries when starting a new game
_____
Succubus Heart ALPHA 3.x (0.6)
- Changed Status Cap cost to be a bit cheaper (again)
- Changed Drain Kill to calculate based on Current Health (was Base Health)
- Changed Increase Rank to Rank Up on Passives
- Changed Saving Essence Passive to apply before combat seduction
- Added Rank Down to Passives
- Added Hover/Display Text entries for all MCM items
- Added Vocabulary section to Help menu (for clarity)
- Added Night's Embrace Spell (Auto-Learned - Forces sleeping actors to submit)
- Added calculations to Passives Display Text (shows actual values)
- Added Gifted Consent Passive (Grants consensual partners stat)
- Added Force Master Passive (Decreases required Force for SP)
- Added Consensual Drain Setting (Enables/Disables drain on consensual partners)
- Fixed Vital Drain [Base-Love] from not working when 2 stack values were the same
- Fixed Vital Drain [Base-Love] Notification Display
- Fixed Vital Drain [Hate] should now be properly named
- Fixed Magicka/Stamina drain being effected by Health Absorption
- Fixed Passives below Masochist leveling Masochist instead of themselves
- Fixed Masochist Passive not working
- Fixed Saving Essence Passive consuming stacks at rank 0
- Fixed Saving Essence Passive working above 30% (instead of below)
- Fixed some Items being improperly tagged
- Fixed Stacks Mechanic (Should be working properly now)
- Fixed player hit effects not updating with the mod
- Fixed a few typos in the MCM
- Fixed -Compatibility- Sperm/Milk not working in iNeed (Hopefully)
_____
Succubus Heart ALPHA 3.x (0.5)
- Removed 100 XP bonus on NPC deaths (replacing with drops system)
- Changed Status Cap costs to be more reasonable
- Changed some MCM sorting
- Changed base XP earn value (10 -> 20)
- Changed Sperm and Milk to be tagged as Food Items (Still acts as ingredients)
- Added Desire Drain Mechanic (After 800 Status converts to Force over-time)
- Added Help Menu Entries (filled it out)
- Added two new rare drops
- Added Sexual Entice Spell (Starts a consensual act - Get through Desire)
- Added Self Pleasure Spell (Starts a solo act - Auto Learned on update)
- Added Focus Shot [Love] Spell (Stronger version of Base)
- Added Cursed Blood [Base] Spell (Targets take extra damage on hit)
- Added Cursed Blood [Love] Spell (Stronger version of Base)
- Added Cursed Blood [Hate] Spell (Kills target after an act)
- Added Vital Drain [Base] Spell (Absorbs status from targets)
- Added Vital Drain [Love] Spell (Stronger version of Base)
- Added Vital Drain [Hate] Spell (Takes status and damage the target)
- Added Spirit Mend [Base] Spell (Converts Magicka to Health)
- Added Spirit Mend [Love] Spell (Stronger version of Base)
- Added Spirit Mend [Hate] Spell (Converts Desire to status)
- Added Soul Bend [Base] Spell (Takes status for high damage)
- Added Soul Bend [Love] Spell (Stronger version of Base)
- Added Soul Bend [Hate] Spell (Uses their own status as damage)
- Added Intimate Touch [Base] (Damage target without aggression)
- Added Intimate Touch [Love] (Stronger version of base)
- Added Intimate Touch [Hate] (Removes enemy Stamina and Magicka)
- Added Magicka Cast costs to all Focus Shot versions
- Added passives system which uses a new ranks system
- Added Perfect Orgasm Passive (Increases rare drop chance)
- Added Luscious Liquids Passive (Recover on sperm/milk consumption)
- Added Masochist Passive (Grants Desire when hit)
- Added Self Stacker Passive (Grants stacks based on gender)
- Added Value Stacker Passive (Increases stacks gained)
- Added Death Drops system (Souls will be placed in dying NPC inventories)
- Added six new Soul Items (Death Drops)
- Fixed Essential in Act setting causing drain kill to not work
- Fixed Spells not swapping out properly when learning new versions
- Fixed Succubus Absorption working in solo acts
- Fixed Solo animation triggering
_____
Succubus Heart vR 0.4
- Removed Pets and Crafting from MCM
- Changed "Focus Shot [Drain]" to "Focus Shot [Hate]"
- Changed effect of Focus Shot [Hate] (was Drain)
- Added more validity checks to Combat Seduction
- Added MCM update function (will show a notification upon updates)
- Added XP to SP converter to Skill Levels
- Added Rare Drops system (Small chance in every act with more than 1)
- Added a new rare drop
- Fixed more cases of overlapping animations
- Fixed Invalid Skill Leveling Values
- Fixed several typos in the MCM
- Fixed some MCM values not updating when changed
- Fixed "sp to next" value not updating correctly in Skill Levels
- Fixed XP Gain not showing properly in Status
_____
Succubus Heart vR 0.3
- Added spell "Focus Shot" [Base] version
- Added spell "Focus Shot" [Drain] version
- Fixed improper release pack format ("Script" should have been "Scripts")
- Fixed Sex Drops not being given to the player
- Fixed Combat Seduction not allowing the player to submit
_____
Succubus Heart vR 0.2
- Changed and vastly improved ANIMcalc function (Improved animation sorting)
- Changed Desire generation to 2/5sec
- Enabled Orgasm effect on Desire (converts 80% into XP)
- Added Combat Seduction Health threshold settings
- Enabled homosexual settings
- Enabled "NPCs Essential in Act" setting
- Fixed animations triggering even when invalid
- Fixed females taking dominate position inappropriately
- Fixed Aggressive / Passive animations tagging incorrectly
_____
Succubus Heart vR 0.1
Initial Re-write release
- Added MCM with all 7 menus
- Status, Skill, and Heart menus are now functional
- Added Sperm and Milk sex drops
- Sperm and Milk consumption effects now enabled
- Sex Effects are now enabled (Absorption)
- "kill effects" implemented (Test effect - 100XP earned when killing an NPC)
- Stacks system enabled (Nothing uses them yet)
- Combat Seduction - Basic Test Version release
- Other basic stuffs
[/Spoiler] 